home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / a2t21.arc / A2T.DOC next >
Text File  |  1991-04-28  |  11KB  |  239 lines
  1.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2.   ░░░░░░░░░╔═══════════════════════════════════════════════════════╗░░░░░░░░
  3.   ░░░░░░░░░║              ┌─────┐             ┌─────┐              ║  ░░░░░░
  4.   ░░░░░░░░░║              │  ─  │             └─┐ ┌─┘              ║  ░░░░░░
  5.   ░░░░░░░░░║              │ ┌─┐ │      2        │ │                ║  ░░░░░░
  6.   ░░░░░░░░░║              └─┘ └─┘               └─┘                ║  ░░░░░░
  7.   ░░░░░░░░░╚═══════════════════════════════════════════════════════╝  ░░░░░░
  8.   ░░░░░░░░░░░                                                         ░░░░░░
  9.   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  10.  
  11.   A2T 2.1 by Robert Kirby
  12.  
  13.   Disclaimer:
  14.      Use this software at your own risk.  No guarantees or warranties.
  15.  
  16.   File info:
  17.   VALIDATE 0.3 Copyright 1988-89 by McAfee Associates.  (408) 988-3832
  18.             File Name:  a2t.exe
  19.                  Size:  10,864
  20.                  Date:  12-26-1989
  21.   File Authentication:
  22.        Check Method 1 - 5EF7
  23.        Check Method 2 - 048F
  24.  
  25.   A2T.EXE --> executable program.
  26.   A2T.DOC --> the docs.
  27.  
  28.  
  29.   Registration:
  30.      This is a shareware program.
  31.      Send $5.00 to:
  32.             Save the Chip Channel
  33.             P.O. Box 270019
  34.             Houston, Tx 77277-0019
  35.      Or call:
  36.             The Houston Chip Channel, BBS# (713)/660-7565
  37.             Node 860/1 of the PhoenixNet
  38.  
  39.  
  40.  
  41.  
  42.      Introduction to A2T, the ASCII to Telix dial directory utility:
  43.  
  44.      This is a program to convert an ASCII file, such as a BBS list into
  45.   a Telix dialing directory.  The program is relatively fast and command
  46.   line driven.  I tailored the initial configuration after a popular BBS
  47.   list that we have here in Houston called "Judy's List", and the most
  48.   common dialing directory settings for an IBM PC or compatible.
  49.      At this time, Judy's List is what A2T works best on, but I will try
  50.   to enhance it to compile just about any ASCII BBS list into a Telix
  51.   dialing directory with a minimum of effort on the user's end.
  52.      A2T takes approximately 2.5 seconds to compile "Judy's List" into a
  53.   Telix dialing directory, and that is on an XT clone.  With A2T, I can
  54.   set up all sorts of BBS lists that I download without having to type
  55.   them up.
  56.  
  57.  
  58.                       Instructions for running A2T:
  59.  
  60.   1) setup the bbs list - this is crucial for proper results.
  61.   2) if you plan to overwrite your current Telix dial dir,
  62.      MAKE A BACKUP of the file named TELIX.FON!
  63.   2) run a2t
  64.  
  65.  
  66.      At this time, A2T has 3 optional parameters.  They are the input
  67.   parameter, the output parameter, and the config parameter.  The input
  68.   parameter is the name of your BBS list in ASCII form.  This must come
  69.   BEFORE the output parameter on the command line.  The output parameter
  70.   if the name of the dialing directory file to be created.  Both of these
  71.   parameters are optional.  If you leave the first one off, you will be
  72.   asked for the name of the ASCII input file, and the output file will
  73.   automatically be TELIX.FON.  To take advantage of the second optional
  74.   output filename parameter, you must enter the first parameter also.
  75.   No suffixes are assumed, that is you must enter them (if you want them)
  76.   in the filename parameters.  You may enter paths for these parameters.
  77.      The third optional parameter is the config parameter.  This is how
  78.   you control the compiling of your BBS list.  The third optional
  79.   parameter is preceeded by a forward slash, and then a code list
  80.   to inform A2T what you want done with the BBS list.  This parameter
  81.   can appear anywhere on the command line.
  82.      If you enter no config parameter at all, you will be given a dialing
  83.   directory that will use 2400bps, and the BBS list should use a '.' for
  84.   the delimiter for the BBS name, and a ' ' for the delimiter for the
  85.   phone number.  This was the easiest way to compile Judy's list, but
  86.   you can override these defaults with config parameters.
  87.      The codes in the config parameter are listed after the forward slash
  88.   and can be in any order but they must have the proper syntax
  89.   to work as described below.
  90.  
  91.      Here are the config parameter definitions:
  92.  
  93.   /Bz    where z = 0, 1, 2, or 9
  94.            This is the Bps parameter code, and will define the bps rate that
  95.          you want in your dial dir.
  96.          Here are the code parameter definitions:
  97.          0 =  300 bps
  98.          1 = 1200 bps
  99.          2 = 2400 bps
  100.          9 = 9600 bps
  101.  
  102.   /D?    where ? = S or C
  103.            This is Delimiter parameter code.  When I first wrote A2T, I wrote
  104.          it for Judy's list which contained a period for the first delimiter
  105.          (which terminates the BBS name) and space for the second delimiter
  106.          (which terminates the phone number).  This strange case is still
  107.          the default if you don't give a delimiter parameter, but if you
  108.          give one, both the BBS name and BBS number delimiters become the
  109.          delimiter that you specify.
  110.          Here are the code parameter definitions:
  111.          S = space
  112.          C = comma
  113.  
  114.   /Ix    where x = 0 through 9
  115.            This is the Ignore parameter code.  This will skip a given number
  116.          of FIELDS in the BBS list, before processing the BBS NAME.
  117.            Note that each field is terminated by a delimiter.  Since I
  118.          originally wrote A2T for a case in which the two delimiters were
  119.          different, the FIRST delimiter (a period) is used for the default
  120.          case.  This can be combined with the D config parameter to use
  121.          a different delimiter.
  122.            Also note that a delimiter consists of one character.  For example,
  123.          if you are using a space for a delimiter, and you have several spaces
  124.          before the BBS name is to be processed, they are each a field skip
  125.          and must be counted separately.
  126.  
  127.   /My    where y = 2 digit number
  128.            This is the Move parameter code.  This will move a specified number
  129.          of COLUMNS on one line of the BBS list before proceeding to process
  130.          the first field.
  131.            This parameter is a little different than the other parameters.
  132.            Firstly, it MUST be the first parameter in the config parameter list.
  133.          For example: /M02ds is OK, but /dSM02 isn't OK.
  134.            Secondly, the M must be followed by a two digit number representing
  135.          the number of columns to move over, even if the digit is less than
  136.          10.  For example: /M02ds is OK, but /M2ds isn't OK.  You can use a
  137.          number anywhere from 01 to 99 to move specific columns.
  138.            Thirdly, the M parameter shouldn't be combined with the I parameter.
  139.          The I parameter is used for one case of skipping fields, and the M
  140.          parameter is used for a completely different case of skipping columns.
  141.  
  142.  
  143. Command line Examples:
  144.      A picture tells 2000 words (that is if you're in text mode)
  145.  
  146. MSDOS_Prompt> A2T [D:path\file] [[D:path\file]]  /config parameter
  147.                         ^               ^
  148.                      This is          This is the optional output file
  149.                     the input         parameter which is only accessable
  150.                    ASCII file.        by entering the first parameter.
  151.  
  152. different config parameters:
  153. /DcI4   ---> use comma for delimiter, skip 4 fields first
  154. /B9DS   ---> use bps rate of 9600, use a space for the delimiter
  155. /B1DsI2 ---> use bps of 1200, use a space for delimiter, ignore 1st 2 fields
  156. /M11ds  ---> move over 11 columns, use a space for a delimiter.
  157.  
  158.  
  159.                       Setting up the BBS list file:
  160.  
  161.      THIS IS THE MOST IMPORTANT PART OF THE WHOLE DEAL.  As mentioned
  162.   earlier, I tailored the program after a popular list here in Houston,
  163.   and used the format of that list so that minor modifications to the
  164.   list would render it usable.
  165.      Three characters have special meanings in the ASCII text file.
  166.      They are:
  167.  
  168.      ';' -----> the semicolon IN THE FIRST COLUMN OF THE LINE, is used
  169.                 to comment out the whole line.  It is VERY important to
  170.                 comment out any line that is not going to be processed!
  171.  
  172.      '.' -----> (or the delimiter you gave on the command line)
  173.                 the period is used to terminate the NAME of the BBS.  This
  174.                 worked fairly well with Judy's list, although I did have
  175.                 to add a terminating period to one or two names, and one
  176.                 or two or three names terminated early because they had
  177.                 periods in the name.  Telix only allows 25 characters for
  178.                 a name, so it is wise to stay below this in your entries.
  179.  
  180.      ' ' -----> (or the delimiter you gave on the command line)
  181.                 the space is used to terminate the PHONE NUMBER of the BBS.
  182.                 Telix only allows 17 characters for a phone number,
  183.                 so it is wise to stay below this in your entries.
  184.  
  185. ;BBS List setup Example:
  186. ;             second is the number, variable length <= 17  (space terminates)
  187. ; Comment line        v
  188. BBS Name.........212-111-1111 Maybe a comment could be here...
  189. ;     ^
  190. ;     the name comes first, variable length <= 25  (period terminates)
  191. ;
  192. ; Note : this is the DEFAULT, you can override these settings with parameters
  193.  
  194.  
  195.      The rest of the information in the ASCII import file will be discarded.
  196.   There are some other givens that you should be aware of.  These are the most
  197.   common settings in a Telix dialing directory for an IBM PC or compatible
  198.   user:
  199.  
  200.      Parity    = NONE
  201.      Data Bits = 8
  202.      Stop Bits = 1
  203.      Protocol  = Zmodem
  204.      Emulation = ANSI-BBS
  205.      Script    = Left Blank
  206.      Password  = Left Blank
  207.  
  208.  
  209. Messages:
  210.  
  211.   If you simply enter :
  212.   MSDOS_Prompt> A2T
  213.   Then you will be prompted :
  214.   "Enter the text input filename:"
  215.  
  216.   "Output file already exists.  Hit <ESC> to abort, any other key if OK."
  217.      If the output file you give exists, you will be notified.
  218.   You will be prompted to hit the <ESC> key to abort the compilation if you
  219.   do not want your TELIX.FON file overwritten.  If you hit any other key,
  220.   the compilation will proceed.
  221.  
  222.   "<BEEP>Sorry, one of your parameters has an error, try again."
  223.      The two main causes for this message are 1) you gave an input filename
  224.   that doesn't exist or 2) you have a syntax error in your parameter config
  225.   list.
  226.  
  227.  
  228.   Version info:
  229.      1.0 - 12-24-89 This is it!  The first version.  I hope to add more
  230.            enhancements very soon.
  231.  
  232.      1.1 - 12-24-89 Corrected a problem that occurred when the user
  233.            entered an incorrect bps parameter.
  234.            
  235.      2.0 - 12-25-89 Added several more parameter command line options.
  236.  
  237.      2.1 - 12-26-89 Improved the record processing display.
  238.  
  239.